Install

Install the CLI, set up your credentials, and launch your first agent. Prefer a native window? Add the desktop app.

Requirements

Python 3.12+
Node.js 22 LTS and npm
tmux

Install Omnigent

The base install covers everyday use. Extra integrations are opt-in at install time. Run the same command to upgrade an existing installation.

curl -fsSL https://omnigent.ai/install.sh | sh

# install an optional integration
curl -fsSL https://omnigent.ai/install.sh | sh -s -- --extra databricks,modal

Available extras:

Category	Extras
Model providers	`databricks`, `bedrock`, `vertex`
Sandbox providers	`modal`, `daytona`, `boxlite`, `cwsandbox`, `e2b`, `openshell`, `kubernetes`
SDK harnesses	`antigravity`, `copilot`, `cursor`, `agents-sdk`
Storage and memory	`s3`, `hindsight`

Set up credentials

The wizard detects credentials in your environment and prompts for any that are missing. See Models & Credentials for the full reference.

omni setup

Launch Debby

Try your install with Debby, a built-in multi-AI agent that sends every question to both Claude and GPT and lets them debate.

omni debby

This launches a web UI and prints the server URL and port. Ask something like What came first, the chicken or the egg? and watch the models challenge each other. See the Debby reference for more.

Install the desktop app

The desktop app gives you the full UI in a native window, and adds OS features a browser can't, like notifications and a dock badge.

Download macOS App

Omnigent desktop app first-launch setup screen

Launch the app. On first launch, you'll see a setup screen.
Enter your server URL. http://localhost:6767 if running locally, or your deployed server URL (e.g. https://your-app.onrender.com).
Start working. The app connects and shows the same UI you'd see in a browser.

See the Desktop app reference for all platforms and details.

Uninstall

omni uninstall removes Omnigent while preserving your data by default. With no destructive flag, it runs a dry-run preview and prints what it would do without changing anything:

omni uninstall

To actually remove the CLI and the installer-managed PATH entries, add --yes. Your local history, credentials, and projects stay in place:

omni uninstall --yes

To also delete Omnigent state under ~/.omnigent, add --purge. Omnigent archives that state to a backup outside the target (under ~/.omnigent-backups/) and prints a restore command before deleting; pass --no-backup to skip the archive. Your ~/omnigent workspace is kept unless you also pass --purge-workspace:

omni uninstall --purge --yes

You can scope the run to one or more targets: cli, state, desktop-data, or all. Other flags cover less common cases: --dry-run to force a preview, --json for machine-readable output, --force to stop stubborn processes and override tamper refusals, and --modify-external-config to allow marker-scoped edits to third-party config files.

If omni itself won't run (broken wheel, or not on your PATH), use the standalone uninstall script instead. It takes the same flags, so add --yes to perform the previewed cleanup:

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/uninstall_oss.sh | sh